home *** CD-ROM | disk | FTP | other *** search
/ Toolkit for Civilization 2 / Walnut Creek CDROM - Toolkit for Civilization II.iso / docs / qpeg386.doc < prev    next >
Text File  |  1996-07-30  |  14KB  |  317 lines
  1. -----------------------------------------------------------------------------
  2.  
  3.                                 Q P E G 3 8 6
  4.                               _________________
  5.                               ~^~^~^~^~^~^~^~^~
  6.  
  7.       A fast JPEG viewer for MS-DOS.  VGA graphics and 80386+ required.
  8.       ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  9.     Currently supports JPEG, Targa (TGA), GIF, PCX, BMP, IFF/ILBM (LBM).
  10.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  11.  
  12. Copyright (c) 1993/94 by Oliver Fromme -- All Rights Reserved
  13.           Oliver Fromme, Klingestr. 2, 38640 Goslar, Germany
  14.  
  15.           Internet email:  fromme@rz.tu-clausthal.de
  16.           WWW:  http://www.rz.tu-clausthal.de/~inof/Welcome.html
  17.  
  18. Version 1.5e of 19-August-1994
  19.  
  20. This program is Shareware.  You may copy the unregistered version, use it,
  21. give it to your friends, upload it to a BBS or something similar, under the
  22. following conditions:
  23.  
  24.  * Don't charge any money for it.  If you upload it to a BBS, make sure that
  25.    it can be downloaded free (without paying for downloading it, except
  26.    for usage fees that have to be paid anyway).  Small copying fees (up to
  27.    5 DM or 3 $US) may be charged.
  28.  * Only distribute the whole original package, with all the files included.
  29.  * Don't change the files in any way, except:
  30.    You may change the INI, CFG, ASM, and DRV files for private purposes.
  31.    Don't distribute modified versions of these files to others without
  32.    prior permission of the author of QPEG386.
  33.  * If you want to include QPEG386 on a CD-ROM and/or book, please send me
  34.    a free copy of the CD/book (this is not a must, but I would appreciate
  35.    it very much).
  36.  
  37. Distribution of the unregistered shareware version is explicitely desired,
  38. provided that the above conditions are accepted.
  39.  
  40. Graphics cards manufacturers:  How about bundling QPEG386 with your product?
  41. I'm sure many of your customers would appreciate that free extra bonus.
  42.  
  43. This software consists of the following files:
  44.  - QPEG386.EXE     the main executable file
  45.  - QPEG386.INI     initialization file (ASCII text)
  46.  - QPEG386.CFG     standard configuration file (ASCII text)
  47. Subdirectories ENGLISH (*=K) and DEUTSCH (*=C):
  48.  - QPEG386.DO*     the documentation
  49.  - CHANGES.DO*     list of changes from previous versions
  50.  - CONFIG.DO*      how to configure QPEG386
  51.  - FAQ.DO*         frequently asked questions
  52.  - REGISTER.DO*    how to register
  53.  - REGISTER.FRM    registration form (English)
  54.  - REGISTER.FOR    registration form (German)
  55.  - UPDATES.DO*     how to get updated versions of QPEG386
  56. Other subdirectories:
  57.  - CFG\*.CFG       various configuration files
  58.  - CFG\CFG.DOC     description of the configuration file format
  59.  - DRV\*.DRV       various video driver files
  60.  - DRVSRC\*.ASM    source codes for the video drivers
  61.  - DRVSRC\DRV.DOC  description of the video driver file format
  62.  
  63. Text files with a DOK extension are German, those with a DOC extension
  64. are English.
  65. There may also be some example JPEG files.  They are not part of the QPEG386
  66. software package.
  67.  
  68. A few warnings, disclaimer etc:
  69.  
  70. IMPORTANT:  Using modes that your hardware (graphics card and/or monitor)
  71. can't handle can damage your hardware!  Be sure to use only supported
  72. modes.  If you come across a mode which looks flickering or unstable
  73. (i.e. the monitor can't hold the picture), abort QPEG386 immediately and
  74. delete that mode from the configuration file.
  75.  
  76. YOU ARE USING QPEG386 AT YOUR OWN RISK!  THE AUTHOR (OLIVER FROMME) IS NOT
  77. LIABLE FOR ANY DAMAGE CAUSED BY THE USE OF QPEG386 OR BY THE INABILITY
  78. TO USE QPEG386.  IF YOU ARE NOT SURE ABOUT THIS, OR IF YOU DON'T ACCEPT
  79. THIS, THEN DO NOT USE QPEG386!
  80.  
  81. QPEG386 is inexpensive shareware.  If you continue using it after a trial
  82. period of 30 days, you are encouraged to pay a small registration fee.
  83. (I try to avoid saying that you MUST register, but actually you MUST.)
  84. The registration is valid for all future updates (you'll get a
  85. registration key which makes the delay disappear).  The source code of
  86. the JPEG decoding routines (Pascal and Asm) used by QPEG386 is also
  87. available.
  88. To become a registered user, please print the file REGISTER.FRM and send
  89. it to me with appropriate payment.  Read the file REGISTER.DOC for further
  90. information.
  91.  
  92. All product names mentioned in this software and documentation are trademarks
  93. or registered trademarks of their respective owners.  They're used in this
  94. software and documentation for identification purposes only.
  95.  
  96. "The Graphics Interchange Format(c) is the Copyright property of
  97. CompuServe Incorporated. GIF(sm) is a Service Mark property of
  98. CompuServe Incorporated."
  99.  
  100. -----------------------------------------------------------------------------
  101.  
  102. What is QPEG386?
  103. ~~~~~~~~~~~~~~~~
  104.  
  105. QPEG386 (Quick-jPEG, pronounce "Q-Peg-386" [kju:peg]) is a viewer for JPEG
  106. image files.  It is about twice as fast as other common JPEG viewers.
  107. Compare it yourself, you'll be surprised.
  108.  
  109. JPEG (Joint Photographic Experts Group, pronounce "Jay-Peg") is an image file
  110. format which uses a "lossy" compression.  JPEG images (they have usually a
  111. "JPG" file extension) are normally very small and offer better compression
  112. than any other image format.
  113.  
  114. Decoding of JPEG images is a rather complicated process, thus it needs a lot
  115. of computing power and performance.  QPEG386 takes advantage of the advanced
  116. features of 80386, 80486 and Pentium (586) CPUs, and it uses large look-up
  117. tables instead of formulas.  Well, I don't want to get into details.  It's
  118. fast, that's all you could want to know.
  119.  
  120.  
  121. Features
  122. ~~~~~~~~
  123.  
  124.  - It's fast (have I mentioned that before?).
  125.  - Uses advanced features of 80386/486 processors (note, the Cyrix 486DLC
  126.    is only an improved 386 rather than a 486).
  127.  - Nice preview ability which is even faster (lets you quickly browse through
  128.    lots of images, very useful if you're searching for a certain image).
  129.  - Works even with a standard VGA card (320x200x16, 640x480x16, 320x200x256).
  130.  - Supports many SVGA cards (virtually all with VESA capability).
  131.  - Uses truecolor (16M color), hicolor (32K color), 256 color (either
  132.    greyscale or dithered color), and 16 color (dithered greyscale) modes.
  133.  - You can pan across an image which is bigger than the current screen
  134.    resolution (scrolling).  Some XMS and/or EMS memory is needed for this.
  135.    You can even pan using your mouse, which is much fun (at least on fast
  136.    local bus machines).
  137.  - You can change the resolution without loading/decoding the image again
  138.    (this is restricted to the same color resolution, for example you can't
  139.    switch from hicolor to truecolor without reloading the image).
  140.  - Supports also the following image file formats (more to come):
  141.     * GIF:
  142.        + interlaced and non-interlaced
  143.        + GIF87a and GIF89a (87a subset only)
  144.        + displays the first image of a multi-image GIF
  145.     * Targa (TGA):
  146.        + truecolor (15, 16, 24 and 32 bit), greyscaled, or with palette
  147.        + uncompressed or rle compressed (run length encoded)
  148.        + supports all video modes (16, 256, 32K, 64K, 16M)
  149.     * PCX:
  150.        + 1 and 4 bit with standard palette
  151.        + 8 bit with extended palette
  152.        + 24 bit truecolor
  153.     * BMP (Windows)
  154.        + 1 bit monochrome with palette, uncompressed
  155.        + 4 and 8 bit with palette, uncompressed or RLE4/8 compressed
  156.        + 24 bit truecolor, uncompressed
  157.     * BMP (OS/2)
  158.        + 1, 4 and 8 bit with palette, uncompressed
  159.        + 24 bit truecolor, uncompressed
  160.        + also supports the new multi image format (BA-BMP)
  161.     * IFF/ILBM (LBM)
  162.        + 1 to 8 bit with palette, and 24 bit truecolor, also DP2 enhanced
  163.        + uncompressed or compressed (ByteRun-1)
  164.        + no HAM yet (due to lack of test images)
  165.  
  166.  
  167. Requirements
  168. ~~~~~~~~~~~~
  169.  
  170.  - 80386 or better CPU (33 MHz minimum recommended), 386SX is sufficient
  171.  - VGA graphics card (SuperVGA recommended, though QPEG386 will run on any
  172.    standard VGA card)
  173.  - some XMS and/or EMS memory (depending on the size of the images), though
  174.    QPEG386 will also run without any XMS/EMS, but then you will be unable to
  175.    do any panning/scrolling
  176.  - about 500 to 550 Kb of free conventional memory
  177.  - MS-DOS 5.0 or compatible operating system
  178.  
  179. A mouse is not required, but it's much more fun than keyboard control!
  180.  
  181. A numeric coprocessor is not required.  If present, it will not be used,
  182. because it would not speed up decoding/displaying.
  183.  
  184.  
  185. Using QPEG386
  186. ~~~~~~~~~~~~~
  187.  
  188. At first you have to configure QPEG386 for your video hardware by running
  189. the SETUP utility once.  Please read the CONFIG.DOC file for more
  190. information.
  191.  
  192. Then just type 'QPEG386' to run it.  There are some command line options
  193. (type 'QPEG386 /?' to get a help message), but they're usually not needed.
  194.  
  195. The graphical user interface of QPEG386 is rather intuitive, so there is no
  196. need for much documentation.  Press the 'F1' key to get a list of all
  197. keyboard functions.  Hit '?' to get a list of keys that can be used while
  198. viewing an image.  You can quit QPEG386 at any time by pressing Alt-X.
  199.  
  200. QPEG386 can also be used as command line viewer (without graphical user
  201. interface).  Type 'QPEG386' followed by one or more filenames.  Wildcards
  202. ('*' and '?') are allowed, too.  Type 'QPEG386 /?' for more information.
  203.  
  204. Experienced users should have a look at the initialization file QPEG386.INI.
  205. It offers many possibilities to change QPEG386's behaviour, you can even
  206. enable some advanced features which are disabled by default (e.g. automatic
  207. video mode selection).  It's a standard ASCII text file, containing
  208. detailed comments for each topic.
  209.  
  210.  
  211. Restrictions and Bugs
  212. ~~~~~~~~~~~~~~~~~~~~~
  213.  
  214. QPEG386 can't handle all kinds of JPEG images.  Specifically, it can only
  215. decode files which comply with the JFIF standard.
  216. See 'Technical Information' below for more details.
  217.  
  218. The maximum image width is 4000 pixel.  QPEG386 will refuse to decode larger
  219. images.  The image height is not limited, but if it's too large it may not
  220. fit into memory (XMS/EMS), thus you can't see the bottom part when scrolling
  221. down.  If this happens, try to use a video mode with less colors, because it
  222. needs less memory (see FAQ.DOC).  Or buy more memory :-)
  223.  
  224.  
  225. How to get an updated version of QPEG386
  226. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  227.  
  228. Please refer to the UPDATES.DOC file.
  229.  
  230.  
  231. Revision history and changes from prior versions
  232. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  233.  
  234. Please refer to the CHANGES.DOC file.
  235.  
  236.  
  237. Technical Information
  238. ~~~~~~~~~~~~~~~~~~~~~
  239.  
  240. QPEG386 can decode greyscaled images (containing a single component using
  241. h1v1 upsampling) and YCbCr true color images (containing three interleaved
  242. components in a single scan, using either Yh2v2, Yh2v1 or Yh1v1 upsampling
  243. for Y and Ch1v1 for Cb/Cr), covering virtually all JFIF files in use today.
  244.  
  245. QPEG386 can handle files that contain restart markers, but it will not use
  246. them for error recovery.  QPEG386 can also display JPEG files which were
  247. created with the 'Adobe Photoshop' (at least version 2.5).
  248.  
  249. The basic JPEG decoding routines are written in pure 386 assembly language,
  250. everything else is written using Borland Pascal 7.0.  I am not using
  251. protected mode, because it would slow down the decoding rather than speeding
  252. it up.  I have linked the JPEG routines into a single easy to use Pascal
  253. unit, which can also be used within other applications.  If you want to
  254. purchase the unit, please read the file REGISTER.DOC for more information.
  255.  
  256. The JPEG unit provides procedures to open and close a JPEG file, read the
  257. file header, and read the image row by row.  It contains routines which
  258. return the lines as 24 bit true color RGB/BGR, 15/16 bit hicolor, 256 color
  259. dithered, 256 color greyscaled, 16 color grayscaled/dithered, and 16 color
  260. greyscaled/dithered for preview (scaled to one eigth or one fourth).
  261.  
  262. A DLL library which can be used for Windows and protected mode applications
  263. is under development and will be available soon.
  264.  
  265.  
  266. Equipment used for Development of QPEG386
  267. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  268.  
  269. Many people are curious about this, so here it is.
  270.  
  271. Hardware:
  272.  - Pentium 90 MHz, 512 Kb cache, 32 Mb RAM, PCI, Neptune chipset, Award BIOS
  273.  - 3.2 Gigabytes of harddisk space (WD, Quantum, Maxtor), both IDE and SCSI
  274.  - magneto optical disk drive (Fuji), 25 optical disks (3.2 Gigabytes)
  275.  - CD-ROM drive (Toshiba, doublespin)
  276.  - 250 Mb tape streamer, 15 tapes (3.75 Gigabytes)
  277.  - Cardex Challenger Pro graphics card, Tseng ET4000-W32p, 2 Mb, truecolor
  278.  - 15" color SVGA monitor w/ digital control & LCD display
  279.  - Advanced Gravis UltraSound (GUS) 1 Mb, Soundblaster, 200 W amplifier
  280.  - 16 bit network card, Ethernet NE2000 compatible, twisted pair + coax
  281.  - 1200 dpi truecolor flatbed scanner
  282.  - TI microLaser PowerPro, 6 Mb RAM, 600 dpi, 12 ppm, Adobe PostScript
  283.  - NEC P60 dot matrix printer
  284.  - Genius mouse, three buttons
  285.  - Highspeed faxmodem 14.4
  286.  - Lots of 3.5" HD floppy disks (mainly Fuji)
  287.  - Printer spooler:
  288.     + intel 80486-DX2/66, 256 Kb cache, 16 Mb RAM, VLB, SIS chips, AMI BIOS
  289.     + 120 Mb harddisk (Conner), IDE
  290.     + Cardex Cobra graphics card, Tseng ET4000/W32i chips, 2 Mb, truecolor
  291.     + 16 bit network card, Ethernet NE2000 compatible, coax
  292.     + Soundblaster
  293.  - Mailbox/BBS (available soon):
  294.     + intel 80386-DX33, 64 Kb cache, 20 Mb RAM, ISA, SIS chipset, AMI BIOS
  295.     + diskless station
  296.     + 16 bit network card, Ethernet NE2000 compatible, coax
  297.     + Highspeed faxmodem 14.4
  298.  
  299. Software:
  300.  - Novell DOS 7 by Novell Inc.
  301.  - Borland Pascal 7.0 by Borland Int.
  302.  - Turbo Assembler 3.2 by Borland Int.
  303.  - XKEY, KEEP8, BOO by Oliver Fromme
  304.  - PKTINY 1.5 by Thomas Mönkemeier
  305.  - TURBODSK 1.1 by Ciriaco García de Celis
  306.  
  307. Special thanks to:
  308.    Thomas Mönkemeier, Lutz Kotoll, Thilo W. Fischer, Rainer Klaffehn,
  309.    Walter Schmies, Stefan Engel, Ben Jos Walbeehm, Uwe Schlenther
  310.    and all of my beta testers!
  311.  
  312. All product names mentioned in this software and documentation are trademarks
  313. or registered trademarks of their respective owners.  They're used in this
  314. software and documentation for identification purposes only.
  315.  
  316. -----------------------------------------------------------------------------
  317.